{% extends "help/index.html" %} 
{% block content %}

<h2>Data Viewer Tab</h2>
<table class="gs-nav"><tr>
  <td><a href="/help/samplestab">&lt; Samples Tab</a></td>
  <td style="text-align: center"><a href="/help/">Index</a></td>
  <td style="text-align: right"><a href="/help/exporttab">Export Tab &gt;</a></td>
</tr></table>


<p>The Data Viewer Tab lets you explore the data that the current container
  is returning to your application.  Use this to debug a container, or see
  which fields are available on Person objects.  This is also a good tool to
  test the individual policies of a container, as permission models on
  more restrictive containers may prevent you from doing things such as
  requesting a user or their friends by ID.</p>
  
<img src="http://osda.appspot.com/img/dataviewertab_1.png" class="center" />

<ol>
  <li value="1"><span>The row of buttons along the top represents 
    the types of data you can request.  Pressing these buttons initiates
    a request to the container for the selected group.</span></li>
  <li value="2"><span>You may also input an ID number and request a 
    user's profile by ID, or a list of the target user's friends. </span></li>
</ol>

<img src="http://osda.appspot.com/img/dataviewertab_2.png" class="center" />

<ol>
  <li value="3"><span>Person records are displayed with their name and a 
    profile picture.</span></li>
  <li value="4"><span>Pressing the "Show details" button on a Person record
    will display a long list of the data that the container has returned 
    about that person.</span></li>
</ol>

<img src="http://osda.appspot.com/img/dataviewertab_3.png" class="center" />

<ol>
  <li value="5"><span>The details view first lists the Person.Field values
    that were obtained by the container.</span></li>
  <li value="6"><span>Values are displayed in green, on the right.  This data
    viewer handles arrays, complex data types, and enum values.</span></li>
  <li value="7"><span>Below the Person.Field entries is a list of all of the
    Persistent data for this person.</span></li>
</ol>

<img src="http://osda.appspot.com/img/dataviewertab_4.png" class="center" />

<p>If a request for a Person or a collection of Person objects fails, you will
  see an error message indicating that the records were not found.  The causes
  of this failure can vary, from the Person not existing, to a request that
  was denied due to policy reasons.</p>

<table class="gs-nav"><tr>
  <td><a href="/help/samplestab">&lt; Samples Tab</a></td>
  <td style="text-align: center"><a href="/help/">Index</a></td>
  <td style="text-align: right"><a href="/help/exporttab">Export Tab &gt;</a></td>
</tr></table>


{% endblock %}